home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / CD-ROM Tools / CD-Player / docs / CD-Player.doc next >
Text File  |  1996-09-26  |  12KB  |  373 lines
  1.  
  2.         -------------------------------------------------------------------------
  3.     Welcome to the newest, best and most flexible CD-Player you've ever seen.
  4.     -------------------------------------------------------------------------
  5.  
  6.                     gmW@Wm
  7.                  ,m@@@A*M@b    gs
  8.                 g@@*~   '@@   i@@
  9.               ,W@A'      @@   W@[
  10.              ,@@f       i@@  d@A
  11.             ,@A'       ,@@[ ,@@'
  12.            ,@@'      iW@@f  W@[
  13.            W@[     mW@@A'  ,@@
  14.           d@@m__gW@@@f'    d@A      gm@@ms    __    __    __     __
  15.          g@@@@@@@@@f'      @@[     g@@*M@@i  i@P    @@ ,m@@@@m   @@_mmms
  16.         ,@@!V***f'         @@'    _@A'  Y@W  d@!   ]@P W@A~~M@b  @@@@*@@i
  17.         d@P               ]@@     @@'    @@  @@    ]@[]@@    @@  @@*  ]@[
  18.        i@@'               ]@A    ]@[     @@  @@    W@[@@[   ,@@ ,@@
  19.        W@[                W@[    W@'     @@ i@P    @@ @@[  ,W@' ]@@
  20.        @@'                @@'    @@     ,@@ ]@[   ,@@ @@@@@@Af  ]@P
  21.       i@@                 @@ ,W@ @@     ]@@ ]@[   ]@@ @@P~~' imiW@[
  22.       ]@[                 @@ !@@ @@    ,@@@ '@W.,gW@@ Y@b    d@[@@'
  23.       d@[                 @@mg@@ M@Ws_g@@Y@i V@@@@@@! `M@@Wm@@A @@
  24.       @@'                 !@@@@A `@@@@@*'`@[  'V*`@@    ~***f'  ** (V1.0ß)
  25.       **                   `V*f                   @A
  26.                                                  ]@[
  27.                                                  W@`
  28.                                             ,gmi,@P
  29.                                            _W@*`d@`
  30.                                           g@Af g@P
  31.                                           @@_gW@A
  32.                                           M@@@*~
  33.  
  34.  
  35.  
  36.  
  37.  
  38. What is this ?
  39. --------------
  40.  
  41.     This is a Audio-CD player program for the Amiga. It was designed to work
  42.         with the Archos Overdrive CD-Rom that has been very popular on the A1200
  43.     but it should work on other drives aswell.
  44.  
  45.  
  46. Credits
  47. -------
  48.  
  49.     Credits for this brilliant Audio CD-Player are as follows:
  50.  
  51.  
  52.  
  53.             Code....................Stian Olsen
  54.             Design..................Espen Skog
  55.             Ideas+Improvements......Stian Olsen & Espen Skog
  56.             Bug-testing.............Espen Skog & Stian Olsen
  57.             This document...........Espen Skog & Stian Olsen
  58.  
  59.  
  60.     We wanna say hi to the following persons: 
  61.  
  62.     Guido Gouweloos, Inge Kuppen, Marcel Bovern, Øyvind Jergan, 
  63.     Dan Cannon, Kajetan Hinner, Snorre Narum, Thomas Hansen, 
  64.     Bill Gates (?) and all users at SilverHawk BBS!
  65.  
  66.  
  67.  
  68.  
  69. Why did we make this ?
  70. ----------------------
  71.  
  72.     When I first got my Overdrive CD-Rom I looked at the CDDA player that
  73.     Archos made and I thought it was horrible. Therefor we decided to make
  74.     a new player based on the Gadtools.library from Commodore. This gave
  75.     the player a much better look and it doesn't open a whole new screen
  76.     like the one Archos made does, therefor it is very handy to have in
  77.     the back of the workbench window. We also thought that the Archos
  78.     player lacked quite a few features, plus that it bugged alot.
  79.  
  80.  
  81.  
  82.     Contact us for suggestions and/or bug-reports:
  83.         ----------------------------------------------
  84.  
  85.     Stian André Olsen            Espen Skog
  86.     Orrelia 2                           Heer Allé 8
  87.     N-1440 Drøbak                       1445 HEER
  88.     Norway                              Norway
  89.  
  90.     Email: stianol@ifi.uio.no           Email: Espen@OsloHd.no
  91.  
  92.  
  93.     Also try our BBS: SilverHawk BBS at +47-64934100/80 (14k4) Amiga+C64
  94.  
  95.  
  96.  
  97. IMPORTANT
  98. ---------
  99.  
  100.     This is a Beat version of the CD-Player, and some buttons are ghosted
  101.     because they are not yet finished! They will probably be working in the
  102.     next version, but that depends on the response we get on this player!
  103.  
  104.  
  105.  
  106. System requirements
  107. -------------------
  108.  
  109.         o Amiga with kick 3.0 or higher (sorry, a 2.0 version will come soon)
  110.         o Overdrive CD-Rom or compatible
  111.     o This program :)
  112.  
  113.     Well, I guess that's all there is to say.
  114.  
  115.  
  116.  
  117.  
  118. Legal information
  119. -----------------
  120.  
  121.     CD-Player V1.0ß software and documentations are copyrighted 1995 by
  122.     Stian André Olsen and Espen Skog. All rights reserved.
  123.  
  124.         We take no responsibility for any damage that may appear after using
  125.     this program. The software is provided "as is" and we reserve the right
  126.     to update the software and documentation without notice.
  127.  
  128.  
  129. Distribution
  130. ------------
  131.  
  132.     The CD-Player is NOT Public Domain, but you may spread it as you
  133.     like. The CD-Player may be put on non-profit PD archives like
  134.     Fred-Fish, AmiNet etc, but we would like you to contact us if
  135.     you do wish to include it in your compilation! 
  136.     This program package must only be spread with its full contents.
  137.  
  138.     CD-Player............................... The main program
  139.     CD-Player.info.......................... Icon for CD-Player
  140.     CD-Player.doc........................... This document
  141.  
  142.  
  143.     ==============================================================
  144.         Documentation of the control-panel in CD-Player
  145.     ==============================================================
  146.  
  147.     If you are having trouble understanding all the features our
  148.     player offers, please read the button-specification to fully
  149.     understand how to control you cd-rom.
  150.  
  151.  
  152.  
  153. « Search, Search »
  154. ------------------
  155.  
  156.     This function is used to fastforward the cd. Search is used when you
  157.     want to skip to a part of the track. If you don't like the beginning
  158.     of  a track, you simply search thru the track until you come to the
  159.     part you like. Search-speed is about 5 times faster than normal play-
  160.     time.
  161.  
  162. Preview
  163. -------
  164.  
  165.     The preview-function is quite handy when you shall browse thry all
  166.     the tracks on the CD. When pressing the Preview button, the player
  167.     will start from the beginning and play 10 seconds of each track
  168.     until it reaches the last track. To disable this function, just press
  169.     Stop.
  170.  
  171.  
  172. << Skip, Skip >> (n/a)
  173. ----------------
  174.  
  175.     Skip let's you skip back and forth to chose one special track to play.
  176.     If the player is in 'stop' mode and you press skip in either direction,
  177.     the player won't start playing before you press play. This gives you the
  178.     possibility to skip to a special track and start playing it whenever
  179.     you want.
  180.  
  181.  
  182. Eject CD
  183. --------
  184.  
  185.     This button will open the cd-door, or close it if the door is open.
  186.     The door is toggled when button is pressed.
  187.  
  188.  
  189. Pause
  190. -----
  191.  
  192.     Just like a normal cd-player, this pauses the CD. By pressing the button
  193.     again, the CD will continue where it was paused.
  194.  
  195.  
  196. Stop
  197. ----
  198.  
  199.     Stop will cause the CD to stop play. Stop will also cancel the Preview
  200.     mode and Pause if selected.
  201.  
  202.  
  203. Play
  204. ----
  205.  
  206.     When pressed, the cd-player will start playing the actual track. If no
  207.     track is specified, it will start playing the first audio-track on the CD.
  208.     If the cd-door is open when play is pressed, it will close automatically.
  209.  
  210.  
  211. Check CD
  212. --------
  213.  
  214.     This button is actually not intended for use, but if you should encounter
  215.     problems like it won't play, playing wrong track etc, then try pressing
  216.     this button! It does the same as when a CD is inserted.
  217.  
  218. Loop functions
  219. --------------
  220.  
  221.     There are three different loop-modes. These are as follows:
  222.  
  223.  
  224.     No Loop : will inactivate all kinds of looping of tracks/cd's.
  225.  
  226.     Loop    : will loop actual track. When the end of the track has
  227.               been reached, it will skip back to the track and play it over
  228.                   again.
  229.  
  230.     Loop CD : starts playing the CD all over again when the end has been
  231.            reached.
  232.  
  233.  
  234.     * Loop is not available in Preview mode.
  235.  
  236.  
  237. Track Slider
  238. ------------
  239.  
  240.     One can very fast select a track by moving the slider to the desired track. 
  241.     For instance, if you want to skip from track 3 to track 56, it would require 
  242.       you to press Skip 53 times, but by using the slider, this is easily done by 
  243.     just moving it to the position. The track-number is also shown at the right 
  244.     most side of the slider, so there is easy to keep control of which track 
  245.     you're on.
  246.  
  247.  
  248. Counter
  249. -------
  250.  
  251.     The counter displays the elapsed time of the track/cd.
  252.  
  253.         00:00:00
  254.         |  |  |___: Seconds 0-59
  255.                 |  |______: Minutes 1-59
  256.                 |_________: Hours   0-99
  257.  
  258.  
  259. Time-toggler
  260. ------------
  261.  
  262.     We added the availability to show the elapsed time of a track, of the whole
  263.     CD and time left of the track and the CD. By togling the button, the
  264.     counter will change according to the mode selected. These modes are:
  265.  
  266.     - Show elapsed track-time
  267.         - Show time left of track
  268.         - Show elapsed CD time
  269.         - Show time left on CD
  270.  
  271.  
  272.  
  273. Status window
  274. -------------
  275.  
  276.     The window at the bottom of the player shows the status of the player.
  277.     It will echo the different states you set the player, and you can then
  278.     see what the player is doing even when your volume is turned down.
  279.     
  280.     Known bug: When you press Play while the CD-door is open, the status
  281.     will display CD-Stopped for a short time. Pay no attention to this ;)
  282.  
  283.  
  284. Random
  285. ------
  286.  
  287.     By switching on the Random-checkbox the player will choose tracks randomly
  288.     when in Play-mode. Press the checkbox again to turn off random-mode.
  289.  
  290.  
  291. Artists (n/a)
  292. -------------
  293.  
  294.     This is a future enhancement of the artist-information window in the
  295.     player. There will be possible to open another window that contain
  296.     more info about the CD and the tracks.
  297.  
  298.  
  299. Program (n/a)
  300. -------------
  301.  
  302.         Being able to make programs so that one can choose the tunes one like
  303.     is very common on most of todays CD players. This is not possible in this
  304.     version of the CD-Player but will be made in another version. When it is
  305.     ready, it will be able to make specific programs for one specific CD and
  306.     to save in the CD info-file that is made when pressing the SAVE ARTIST-LIST,
  307.         so that next time you insert the CD, the CD-Player knows what tunes you like
  308.     most. This will of course be optional.
  309.  
  310.  
  311. Special features (n/a)
  312. ----------------------
  313.  
  314.     We've added a special feature that recognises the CD and automatically
  315.     show the name of the group and the track-name. But the user has to write
  316.     the name of each track and then save a data-file by pressing the
  317.     SAVE ARTIST-LIST button. Everything is done automatically, and all you have
  318.     to do is to fill out the strings for each track and press the save button
  319.     when all tracks are ready. Next time you insert this CD the player will
  320.     automatically read the right data from the data-file and then show
  321.     the name of the track plus the name of the group/artist whenever you choose
  322.     to skip track. The datafile is stored in S: with the name CDPlayer.Data
  323.  
  324.  
  325.  
  326. History
  327. -------
  328.  
  329.     Version 1.0ß:    First release, but has been under development and
  330.     (25/2/95)    bugtesting for quite some time. Project first
  331.             started when trying to control cd.device. This
  332.             turned out to be working, and we made a GUI.
  333.             Changed GUI about 3-4 times before we made the
  334.             one you see in this version. GUI will probably
  335.             change throughout future versions. Program-mode was
  336.             designed, but not implemented in this version due
  337.             to lack of time. Released 'cos of lack of
  338.             interest to continue....bye
  339.     
  340.  
  341.  
  342.  
  343.  
  344.  
  345. Known bugs
  346. ----------
  347.  
  348.     Timer-Bug:  There may be some errors in the timer when it's stressed alot.
  349.                 For instance, if you search back and forth and pause alot it may
  350.             show +-1 second from the original time. Since this is such a small
  351.             problem, we decided not to do anymore about this second. If, for
  352.             some reason, we find out that a 100% correct timer is needed, we
  353.             will try to fix it. But in the meantime, this will do.
  354.  
  355.  
  356. Final Note
  357. ----------
  358.  
  359.     If you encounter a bug, you like the CD-Player, you don't like the CD-Player,
  360.     use it frequently or have anything else to say about it, then either mail
  361.     us, or call our support BBS, SilverHawk BBS (where Stian Olsen actually
  362.     is the Sysop, and Espen Skog is CoSysop :) ).
  363.     Future development will heavily depend on your response. We know that 
  364.     there is a great need for a CD-Player for the Archos drive, so we hope
  365.     you like and support this program.
  366.  
  367.     We have not tested this player either on a CD32 or a SCSI CD-ROM, but
  368.     if you've got one, please test this program and mail us about the result.
  369.  
  370.     BTW: Could someone design a nice icon for the CD-Player (both MagicWB and 
  371.     normal WB). You will be credited :)
  372.  
  373.